home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl040 / check34j.lzh / CHECK34.DOC < prev    next >
Text File  |  1992-10-29  |  12KB  |  308 lines
  1.  
  2. ═════════════════════════════════════════════════════════════════════════════=
  3.                        Multi Player Checkers Door
  4.  
  5.                         Only $10.00 to register!
  6.  
  7.               Written by: Gerry Freymann
  8.                           P.O. Box 1226
  9.                           Cobourg, Ontario Canada
  10.                           K9A 5A4
  11.  
  12.           The Phantom BBS (416) 342-3734 USR HST Dual Standard
  13.                           (416) 342-3766 19200 USR HST
  14.  
  15.     The latest versions/updates are available on The Phantom BBS and
  16.  
  17.                               TDS Network
  18.                    The PC ToyShop Information System
  19.                          24 Hours, 300 -> 38.4K
  20.                              (503) 342-4447
  21.                              Eugene, Oregon
  22.  
  23. ═════════════════════════════════════════════════════════════════════════════=
  24.  
  25. ┌─────────────────────────────────────────────────────────────────────────┐
  26. │                        Warranty and Liability                           │
  27. └─────────────────────────────────────────────────────────────────────────┘
  28.  
  29. I retain the Copyright to this program.  You are NOT allowed to make
  30. changes to the compiled .EXE files without the expressed written consent
  31. of Gerry Freymann.  I work hard creating these programs and don't
  32. appreciate having my work altered.
  33.  
  34. I will NOT be held responsible for the use and/or misuse of this program.
  35. If you decide to run this program on your system you do so at your own
  36. risk.
  37.  
  38. PCBoard is a trademark of Clark Development Company.
  39.  
  40.  
  41.  
  42. ┌────────────────────────────────────────────────────────────────────────┐
  43. │                         Checker History File                           │
  44. └────────────────────────────────────────────────────────────────────────┘
  45. Please view the file CHANGES.DOC for a complete history.
  46.  
  47.  
  48. ┌────────────────────────────────────────────────────────────────────────┐
  49. │                         Checker Requirements                           │
  50. └────────────────────────────────────────────────────────────────────────┘
  51.  
  52. Multiple BBS support: DOOR.SYS, PCBOARD.SYS/PCBOARD.DAT/USERS,
  53. SFDOORS.DAT, CALLINFO.BBS, DORINFO1.DEF, DORINFO2.DEF and
  54. CHAIN.TXT
  55.  
  56. Directly supports PCBoard 14.x, GAP v4.x, RBBS-PC v17.x,
  57. WILDCAT! v2.x and Spitfire v3.x
  58.  
  59. A copy of BRUN30.EXE in your PATH= statement
  60.  
  61. DoorPatch 3.8 package
  62.  
  63.  
  64. ┌─────────────────────────────────────────────────────────────────────────┐
  65. │                         Overview of Checkers                            │
  66. └─────────────────────────────────────────────────────────────────────────┘
  67.  
  68. Welcome to Checkers!  A Multiplayer Door for PCBoard Ver 14.x written
  69. in QuickBasic 3 with Door Patch Ver 3.8!
  70.  
  71. Checkers was a program I first found way back in my Commodore days.
  72. It was a PUBLIC DOMAIN file and the author's name was not included.  Some
  73. routines and code from the very original program exist in various forms
  74. in this Door program.
  75.  
  76. One interesting feature of Checkers is its ability to automatically play
  77. a game against a user while tricking the user into thinking it's really
  78. you!  Don't believe me?  Try the Page Sysop For A Game feature and see what
  79. you think.  The comments "typed" to the user are contained in the CFG
  80. file which you should edit to give the door your personal touch.
  81.  
  82.  
  83. ┌─────────────────────────────────────────────────────────────────────────┐
  84. │                         Features of Checkers                            │
  85. └─────────────────────────────────────────────────────────────────────────┘
  86.  
  87. ■ Supports baud rates up to 115,200 baud!
  88.  
  89. ■ Multiple BBS support
  90.  
  91. ■ ASCII and ANSI Bulletins automatically created
  92.  
  93. ■ Nightly event utility maintains index file, rewrites bulletins and
  94.   deletes stale dated and completed games
  95.  
  96. ■ Low one-time registration fee!
  97.  
  98. ■ Keeps a Hall of Fame
  99.  
  100. ■ Users can send one line messages to their opponent
  101.  
  102. ■ Fully Network compatible
  103.  
  104. ■ Automatic Sysop vs. User mode
  105.  
  106.  
  107. ┌─────────────────────────────────────────────────────────────────────────┐
  108. │                        How to Install Checkers                          │
  109. └─────────────────────────────────────────────────────────────────────────┘
  110.  
  111. First Time Installation
  112. ──────────────────────────────────────────────────────────────────────────
  113.  
  114. Step 1)
  115. ──────
  116. Create a SubDirectory to place all of the Checkers files in.  Let's say
  117. C:\DOORS\CHECKERS
  118.  
  119. Step 2)
  120. ──────
  121. Unzip (or copy) the contents of CHECKERS ZIP into C:\DOORS\CHECKERS.  You
  122. need to edit the CHECKERS.CFG file as follows:
  123.  
  124. Line #1 => C:\PCB\PCBOARD.SYS  (The location for the BBS I/O file)
  125. Line #2 => The Phantom BBS     (The BBS' name)
  126. Line #3 => Gerry               (Sysop first name)
  127. Line #4 => Freymann            (Sysop last name)
  128. Line #5 => Mr. Donor           (The donor of the DOOR)
  129. Line #6 => 20                  (Max. # of games you want underway)
  130. Line #7 => C:\GAMES\GBLT1      (Full path/name of ASCII Bulletin)
  131. Line #8 => C:\GAMES\GBLT1G     (Full path/name of ANSI Bulletin)
  132. Line #9 to Line #33            (Comments door types in AutoPlay Mode)
  133.            "On no!  Not another user to abuse?"
  134.            "etc"
  135.  
  136. Lines 9 through 33 hold the comments the door will type to the user when
  137. the Page Sysop for a Game option is used.  These lines should be edited
  138. by you to add your personal touch and should start and end with quotes.
  139.  
  140. The maximum number of games that can be underway at one time is 100.
  141.  
  142. If you don't wish to create one or either bulletins simply put the
  143. word "NULL" on line 7 and 8.
  144.  
  145. Step 3)
  146. ──────
  147. Edit the file CHECKERS - this should be placed in your \PCB directory and
  148. will be used to call up the door.  A typical batch file for PCBoard would
  149. like this:
  150.  
  151. ECHO OFF
  152. C:
  153. CD\DOORS\CHECKERS
  154. CHECK34 CHECKERS.CFG
  155. C:
  156. CD\PCB
  157. BOARD
  158.  
  159. Step 4)
  160. ──────
  161. Edit your DOORS.LST file using PCBSetup and include CHECKERS.
  162.  
  163. Step 5)
  164. ──────
  165. Edit your DOORS Menu screen to include CHECKERS.
  166.  
  167. Step 6)
  168. ──────
  169. Set up and configure DoorPatch.  This release uses DoorPatch 3.8 and it
  170. operates a little differently than previous DoorPatch releases.  Here
  171. is all you need to do:
  172.  
  173. Unzip the DoorPatch 3.8 package into a subdirectory.
  174. Two environment variables must be set in your AUTOEXEC.BAT file:
  175.  
  176. SET LIB=<drive:><path to DORPCH38.EXE>  Note: ONLY the PATH!
  177.  
  178. Example:  SET LIB=C:\MYLIB
  179.  
  180. The DORPCH38.EXE run-time library and DOORPCH.CFG files must then
  181. be placed in this directory.
  182.  
  183. SET DOORPCH=PCB     This variable is required by prior versions
  184.                      of DOORPCH, but not by DORPCH38.EXE.
  185.  
  186. Create DOORPCH.CFG in the same directory where you placed the DoorPatch
  187. 3.8 files.  The data in this file lets you setup DoorPch for your BBS.
  188. This is not the same as CHECKERS.CFG - this is a separate configuration
  189. file used to configure DoorPatch 3.8.
  190.  
  191. Line #1 => PCBoard          (The type of BBS software used)
  192. Line #2 => The Phantom BBS  (The BBS's name)
  193. Line #3 => Gerry            (Sysop first name)
  194. Line #4 => Freymann         (Sysop last name)
  195. Line #5 => Y                (Do you have DOS's Share.exe loaded?)
  196. Line #6 => Y                (Y or N - Do you want PCBoard's "@" macros?)
  197. Line #7 => N                (Y or N - Do you want to hear music?)
  198. Line #8 => 18:00-23:00      (Hours available for chat)
  199.  
  200. Step 7)
  201. ──────
  202. Edit your \PCB\EVENT.SYS file and change to C:\DOORS\CHECKERS and call
  203. up CHKILL to run the maintenance program.  You don't have to run this
  204. everyday - once a month will do!  Until you register Checkers the event
  205. utility won't do anything.  This will not affect you until a game is
  206. completed and you want to get rid of it so this will have no ill effects
  207. while you decide if Checkers is for you.
  208.  
  209. Step 8)
  210. ──────
  211. Print out the ORDER.FRM and think about registering this product
  212. someday soon ;-) !
  213.  
  214.  
  215. Upgrading from a Previous Version of Checkers
  216. ───────────────────────────────────────────────────────────────────────────
  217.  
  218. If you have been running a previous release of Checkers - you should be sure
  219. to read over CHANGES.DOC.  Update instructions from version to version are
  220. detailed there.
  221.  
  222.  
  223. ┌─────────────────────────────────────────────────────────────────────────┐
  224. │                       Command-line parameters                           │
  225. └─────────────────────────────────────────────────────────────────────────┘
  226.  
  227. Once you've configured DoorPatch 3.8 you run Checkers in local mode by
  228. using the /LOCAL command-line switch as follows:
  229.  
  230.         CHECK34 CHECKERS.CFG /LOCAL   <== Allows local usage of the DOOR as
  231.                                           the SysOp.
  232.  
  233.  
  234. ┌─────────────────────────────────────────────────────────────────────────┐
  235. │              Files needed for Checkers Door Operation                   │
  236. └─────────────────────────────────────────────────────────────────────────┘
  237.  
  238. *  CHECK34.EXE      <<--The main program
  239. * CHECKERS.CFG      <<--A sample configuration file
  240.   CHECKERS          <<--A sample file to run the whole thing
  241. * CHECKERS.INS      <<--The instructions the user will see
  242.    CHECK34.DOC      <<--I luv this part - You're reading it right now!
  243. *   CHKILL.EXE      <<--Sysop Maintenance program, use in your Event.Sys
  244.    LICENSE.DOC      <<--You must read, understand and agree to this!
  245.      SYSOP.DOC      <<--Full DoorPatch Instructions
  246.      FLYER.DOC      <<--Information on other programs available from me
  247.      ORDER.FRM      <<--Registration Form - print out and return
  248.  
  249. Files created by the program after running it:
  250.  
  251. * CHECKERS.SCR      <<--Hall of Fame is held in here once a game has ended
  252. * CHECKERS.0??      <<--Games currently underway, ?? equals 01 to 100
  253. * CHECKERS.NDX      <<--Quick index of all the Games
  254. * CHECKERS.REG      <<--Created by CHECKREG.EXE after registering
  255.  
  256. Files needed for Door Patch Operation:
  257.  
  258. * DORPCH38.EXE     <<--If you don't have these I can make them available to
  259.     BRUN30.EXE     <<--to you on my Board.
  260.  
  261. [*] - these files must be in the same directory
  262.  
  263.  
  264. ┌─────────────────────────────────────────────────────────────────────────┐
  265. │                       Maintenance Program                               │
  266. └─────────────────────────────────────────────────────────────────────────┘
  267.  
  268. To invoke CkKill you MUST provide a name of .CFG you use which allows
  269. ChKill to read where your Bulletins will be placed.  By DEFAULT ChKill
  270. will attempt to open CHECKERS.CFG - if you are using a different name for
  271. your CFG file then you must pass that information to ChKill.  For
  272. example:
  273.  
  274.         CHKILL               <-- Will read CHECKERS.CFG by Default
  275.  
  276. or:     CHKILL CHK.CFG       <-- Will read CHK.CFG
  277.  
  278. The maintenance program's main purpose is to delete finished or stale
  279. dated games.  ChKill automatically deletes games that have not had a
  280. move made in them for 45 days.  ChKill will tidy up the Index file and
  281. rewrite the bulletins.  If your game files ever get out of sync with
  282. the index file ChKill will fix it all up.  ChKill logs all its activity
  283. into CHECKERS.LOG.  Until you register Checkers the event utility won't
  284. do anything.  This will not affect you until a game is completed and
  285. you want to get rid of it so this will have no ill effects while you
  286. decide if Checkers is for you.
  287.  
  288.  
  289. Support the Shareware concept...
  290. ──────────────────────────────────────────────────────────────────────────
  291. To Register, please print out and return the ORDER.FRM in the Zip file.
  292. When you register, you will be given a small program called CHKREG.EXE
  293. which you run in your door subdirectory.  This program will create a file
  294. called CHECKERS.REG which will instantly register your existing copy of the
  295. door program, unlock the maintenance program and any and all future
  296. versions as well.  This means that any future releases you find will
  297. automatically continue to say registered to you, without the need to come
  298. back to me.  I hope you'll appreciate this new system.  You should be able
  299. to call The Phantom BBS and make your initial call, wait until I receive
  300. your payment, and download this small utility without spending alot of time
  301. on the phone.  Or, for an additional $5.00 per order, I can send you the
  302. whole package on disk using the postal service.  The choice is yours.
  303.  
  304.  
  305.                         Thanks for your support!
  306.  
  307.  
  308.